home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / dma_map.z / dma_map
Encoding:
Text File  |  2002-10-03  |  2.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ddddmmmmaaaa____mmmmaaaapppp((((DDDD3333XXXX))))                                                      ddddmmmmaaaa____mmmmaaaapppp((((DDDD3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _dddd_mmmm_aaaa______mmmm_aaaa_pppp - load DMA mapping registers for an imminent transfer
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_""""
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_ssss_eeee_mmmm_aaaa_...._hhhh_""""
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _""""_ssss_yyyy_ssss_////_dddd_mmmm_aaaa_mmmm_aaaa_pppp_...._hhhh_""""
  15.  
  16.      _iiii_nnnn_tttt _dddd_mmmm_aaaa______mmmm_aaaa_pppp_((((_dddd_mmmm_aaaa_mmmm_aaaa_pppp______tttt _****_d_m_a_m_a_p_,,,,_cccc_aaaa_dddd_dddd_rrrr______tttt _k_e_r_n_e_l__v_a_d_d_r_,,,, _iiii_nnnn_tttt _n_u_m__b_y_t_e_s_))))_;;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _dddd_mmmm_aaaa______mmmm_aaaa_pppp attempts to map _n_u_m__b_y_t_e_s of main memory starting at the kernel
  20.      virtual address _k_e_r_n_e_l__v_a_d_d_r, using the previously allocated DMA map
  21.      _d_m_a_m_a_p.  _dddd_mmmm_aaaa______mmmm_aaaa_pppp determines the actual physical memory locations for the
  22.      given address and range and loads them into the mapping registers
  23.      corresponding to the map.  These mapping registers remain undisturbed
  24.      until another call to _dddd_mmmm_aaaa______mmmm_aaaa_pppp.
  25.  
  26.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  27.      _dddd_mmmm_aaaa______mmmm_aaaa_pppp returns the actual number of bytes mapped.  This number may be
  28.      less than that requested if the number of map registers required exceeds
  29.      the size of the given DMA map.
  30.  
  31.      0 is returned if the arguments are invalid, for instance, if a
  32.      _k_e_r_n_e_l__v_a_d_d_r is not word aligned.
  33.  
  34.    SSSSeeeeeeee AAAAllllssssoooo
  35.      dma_mapaddr(D3X), dma_mapalloc(D3X), dma_mapfree(D3X), vme_adapter(D3X).
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.